NewQuickAction 技术文档

1. 安装指南

1.1 添加依赖

首先，在你的 build.gradle 文件中添加 NewQuickAction 库的依赖：

dependencies {
    implementation 'com.lorensiuswlt:NewQuickAction:1.0.0'
}

1.2 同步项目

添加依赖后，点击 "Sync Now" 按钮，确保项目与依赖库同步。

2. 项目的使用说明

2.1 创建 QuickAction 对话框

在 Activity 中创建 QuickAction 对话框的步骤如下：

1. 创建 ActionItem 对象，每个对象代表一个操作项。
2. 将 ActionItem 添加到 QuickAction 对象中。
3. 设置 QuickAction 的点击监听器和消失监听器。
4. 将 QuickAction 绑定到按钮的点击事件上。

2.2 示例代码

以下是一个完整的示例代码，展示了如何创建和使用 QuickAction 对话框：

public class Example1Activity extends Activity {
    private static final int ID_ADD = 1;
    private static final int ID_ACCEPT = 2;
    private static final int ID_UPLOAD = 3;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.example1);

        ActionItem addItem = new ActionItem(ID_ADD, "Add", getResources().getDrawable(R.drawable.ic_add));
        ActionItem acceptItem = new ActionItem(ID_ACCEPT, "Accept", getResources().getDrawable(R.drawable.ic_accept));
        ActionItem uploadItem = new ActionItem(ID_UPLOAD, "Upload", getResources().getDrawable(R.drawable.ic_up));

        // 设置 uploadItem 为 sticky 模式，点击后不会关闭对话框
        uploadItem.setSticky(true);

        final QuickAction mQuickAction = new QuickAction(this);

        mQuickAction.addActionItem(addItem);
        mQuickAction.addActionItem(acceptItem);
        mQuickAction.addActionItem(uploadItem);

        // 设置操作项点击监听器
        mQuickAction.setOnActionItemClickListener(new QuickAction.OnActionItemClickListener() {
            @Override
            public void onItemClick(QuickAction quickAction, int pos, int actionId) {
                ActionItem actionItem = quickAction.getActionItem(pos);

                if (actionId == ID_ADD) {
                    Toast.makeText(getApplicationContext(), "Add item selected", Toast.LENGTH_SHORT).show();
                } else {
                    Toast.makeText(getApplicationContext(), actionItem.getTitle() + " selected", Toast.LENGTH_SHORT).show();
                }
            }
        });

        // 设置对话框消失监听器
        mQuickAction.setOnDismissListener(new QuickAction.OnDismissListener() {
            @Override
            public void onDismiss() {
                Toast.makeText(getApplicationContext(), "Ups..dismissed", Toast.LENGTH_SHORT).show();
            }
        });

        Button btn1 = (Button) this.findViewById(R.id.btn1);
        btn1.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                mQuickAction.show(v);
            }
        });

        Button btn2 = (Button) this.findViewById(R.id.btn2);
        btn2.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                mQuickAction.show(v);
                mQuickAction.setAnimStyle(QuickAction.ANIM_GROW_FROM_CENTER);
            }
        });
    }
}

3. 项目API使用文档

3.1 ActionItem 类

ActionItem 类用于表示 QuickAction 对话框中的一个操作项。

构造函数

• ActionItem(int id, String title, Drawable icon)：创建一个带有 ID、标题和图标的操作项。

方法

• void setSticky(boolean sticky)：设置操作项是否为 sticky 模式，即点击后是否关闭对话框。

3.2 QuickAction 类

QuickAction 类用于创建和管理 QuickAction 对话框。

构造函数

• QuickAction(Context context)：创建一个 QuickAction 对象。

方法

• void addActionItem(ActionItem actionItem)：向对话框中添加一个操作项。
• void setOnActionItemClickListener(OnActionItemClickListener listener)：设置操作项点击监听器。
• void setOnDismissListener(OnDismissListener listener)：设置对话框消失监听器。
• void show(View anchor)：显示 QuickAction 对话框，anchor 是触发对话框的视图。
• void setAnimStyle(int animStyle)：设置对话框的动画样式。

4. 项目安装方式

4.1 通过 Gradle 安装

在项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.lorensiuswlt:NewQuickAction:1.0.0'
}

4.2 通过 Maven 安装

如果你使用 Maven，可以在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.lorensiuswlt</groupId>
    <artifactId>NewQuickAction</artifactId>
    <version>1.0.0</version>
</dependency>

4.3 手动安装

你也可以手动下载库的 JAR 文件，并将其添加到项目的 libs 目录中。

---

通过以上步骤，你可以轻松地在 Android 项目中使用 NewQuickAction 库来创建 QuickAction 对话框。