Prompts 提示集

用于显示一组与当前上下文相关的预定义的问题或建议。

代码演示

基本

不可用状态

☕️ It's time to relax!

Task Completion Secrets

What are some tricks for getting tasks done?

Time for a Coffee Break

How to rest effectively after long hours of work?

不可用状态

要将 prompt 标记为禁用，请向 prompt 添加 disabled 属性。

<script setup lang="tsx">
defineOptions({ name: 'AXPromptsDisabledV2' });

import { CheckCircleOutlined, CoffeeOutlined } from '@ant-design/icons-vue';
import { Prompts, type PromptsProps } from 'ant-design-x-vue';

const items: PromptsProps['items'] = [
  {
    key: '5',
    icon: <CheckCircleOutlined style={{ color: '#52C41A' }} />,
    label: 'Task Completion Secrets',
    description: 'What are some tricks for getting tasks done?',
    disabled: true,
  },
  {
    key: '6',
    icon: <CoffeeOutlined style={{ color: '#964B00' }} />,
    label: 'Time for a Coffee Break',
    description: 'How to rest effectively after long hours of work?',
  },
];

defineRender(() => (
  <Prompts title="☕️ It's time to relax!" items={items} />
));
</script>

隐藏源代码

渐入效果

✨ Inspirational Sparks and Marvelous Tips

Ignite Your Creativity

Got any sparks for a new project?

Uncover Background Info

Help me understand the background of this topic.

Efficiency Boost Battle

How can I work faster and better?

Tell me a Joke

Why do not ants get sick? Because they have tiny ant-bodies!

Common Issue Solutions

How to solve common issues? Share some tips!

渐入效果

通过 fadeIn 和 fadeInLeft 属性控制渐入动画效果。

<script setup lang="tsx">
defineOptions({ name: 'AXPromptsFadeInV2' });

import {
  BulbOutlined,
  InfoCircleOutlined,
  RocketOutlined,
  SmileOutlined,
  WarningOutlined,
} from '@ant-design/icons-vue';
import { Button, Flex, Switch, message } from 'ant-design-vue';
import { Prompts, type PromptsProps } from 'ant-design-x-vue';
import { ref } from 'vue';

const key = ref(0);
const fadeInLeft = ref(true);

const items: PromptsProps['items'] = [
  {
    key: '1',
    icon: <BulbOutlined style={{ color: '#FFD700' }} />,
    label: 'Ignite Your Creativity',
    description: 'Got any sparks for a new project?',
  },
  {
    key: '2',
    icon: <InfoCircleOutlined style={{ color: '#1890FF' }} />,
    label: 'Uncover Background Info',
    description: 'Help me understand the background of this topic.',
  },
  {
    key: '3',
    icon: <RocketOutlined style={{ color: '#722ED1' }} />,
    label: 'Efficiency Boost Battle',
    description: 'How can I work faster and better?',
  },
  {
    key: '4',
    icon: <SmileOutlined style={{ color: '#52C41A' }} />,
    label: 'Tell me a Joke',
    description: 'Why do not ants get sick? Because they have tiny ant-bodies!',
  },
  {
    key: '5',
    icon: <WarningOutlined style={{ color: '#FF4D4F' }} />,
    label: 'Common Issue Solutions',
    description: 'How to solve common issues? Share some tips!',
  },
];

defineRender(() => (
  <Flex gap="middle" vertical>
    <Flex gap="middle" align="center">
      <Switch
        style={{ alignSelf: 'flex-end' }}
        checkedChildren="fadeInLeft"
        unCheckedChildren="fadeIn"
        v-model:checked={fadeInLeft.value}
      />
      <Button style={{ alignSelf: 'flex-end' }} onClick={() => (key.value++)}>
        Re-Render
      </Button>
    </Flex>
    <Prompts
      key={key.value}
      fadeIn={!fadeInLeft.value}
      fadeInLeft={fadeInLeft.value}
      title="✨ Inspirational Sparks and Marvelous Tips"
      items={items}
      onItemClick={(info) => {
        message.success(`You clicked a prompt: ${info.data.label}`);
      }}
    />
  </Flex>
));
</script>

隐藏源代码

纵向展示

🤔 You might also want to ask:

How to rest effectively after long hours of work?

What are the secrets to maintaining a positive mindset?

How to stay calm under immense pressure?

纵向展示

使用 vertical 属性，控制 Prompts 展示方向。

<script setup lang="tsx">
defineOptions({ name: 'AXPromptsFlexVerticalV2' });

import { CoffeeOutlined, FireOutlined, SmileOutlined } from '@ant-design/icons-vue';
import { Prompts, type PromptsProps } from 'ant-design-x-vue';

const items: PromptsProps['items'] = [
  {
    key: '6',
    icon: <CoffeeOutlined style={{ color: '#964B00' }} />,
    description: 'How to rest effectively after long hours of work?',
    disabled: false,
  },
  {
    key: '7',
    icon: <SmileOutlined style={{ color: '#FAAD14' }} />,
    description: 'What are the secrets to maintaining a positive mindset?',
    disabled: false,
  },
  {
    key: '8',
    icon: <FireOutlined style={{ color: '#FF4D4F' }} />,
    description: 'How to stay calm under immense pressure?',
    disabled: false,
  },
];

defineRender(() => (
  <Prompts title="🤔 You might also want to ask:" items={items} vertical />
));
</script>

隐藏源代码

可换行

✨ Inspirational Sparks and Marvelous Tips

Got any sparks for a new project?

Help me understand the background of this topic.

How to solve common issues? Share some tips!

How can I work faster and better?

What are some tricks for getting tasks done?

How to rest effectively after long hours of work?

What are the secrets to maintaining a positive mindset?

How to stay calm under immense pressure?

可换行

使用 wrap 属性，控制 Prompts 超出区域长度时是否可以换行。

<script setup lang="tsx">
defineOptions({ name: 'AXPromptsFlexWrapV2' });

import {
  BulbOutlined,
  CheckCircleOutlined,
  CoffeeOutlined,
  FireOutlined,
  InfoCircleOutlined,
  RocketOutlined,
  SmileOutlined,
  WarningOutlined,
} from '@ant-design/icons-vue';
import { Prompts, type PromptsProps } from 'ant-design-x-vue';

const items: PromptsProps['items'] = [
  {
    key: '1',
    icon: <BulbOutlined style={{ color: '#FFD700' }} />,
    description: 'Got any sparks for a new project?',
  },
  {
    key: '2',
    icon: <InfoCircleOutlined style={{ color: '#1890FF' }} />,
    description: 'Help me understand the background of this topic.',
  },
  {
    key: '3',
    icon: <WarningOutlined style={{ color: '#FF4D4F' }} />,
    description: 'How to solve common issues? Share some tips!',
  },
  {
    key: '4',
    icon: <RocketOutlined style={{ color: '#722ED1' }} />,
    description: 'How can I work faster and better?',
  },
  {
    key: '5',
    icon: <CheckCircleOutlined style={{ color: '#52C41A' }} />,
    description: 'What are some tricks for getting tasks done?',
  },
  {
    key: '6',
    icon: <CoffeeOutlined style={{ color: '#964B00' }} />,
    description: 'How to rest effectively after long hours of work?',
  },
  {
    key: '7',
    icon: <SmileOutlined style={{ color: '#FAAD14' }} />,
    description: 'What are the secrets to maintaining a positive mindset?',
  },
  {
    key: '8',
    icon: <FireOutlined style={{ color: '#FF4D4F' }} />,
    description: 'How to stay calm under immense pressure?',
  },
];

defineRender(() => (
  <Prompts title="✨ Inspirational Sparks and Marvelous Tips" items={items} wrap />
));
</script>

隐藏源代码

响应式宽度

✨ Inspirational Sparks and Marvelous Tips

Ignite Your Creativity

Got any sparks for a new project?

Uncover Background Info

Help me understand the background of this topic.

Efficiency Boost Battle

How can I work faster and better?

Tell me a Joke

Why do not ants get sick? Because they have tiny ant-bodies!

Common Issue Solutions

How to solve common issues? Share some tips!

响应式宽度

配合 wrap 与 styles 固定宽度展示。

<script setup lang="tsx">
defineOptions({ name: 'AXPromptsFlexWrapFixedV2' });

import {
  BulbOutlined,
  InfoCircleOutlined,
  RocketOutlined,
  SmileOutlined,
  WarningOutlined,
} from '@ant-design/icons-vue';
import { Prompts, type PromptsProps } from 'ant-design-x-vue';

const items: PromptsProps['items'] = [
  {
    key: '1',
    icon: <BulbOutlined style={{ color: '#FFD700' }} />,
    label: 'Ignite Your Creativity',
    description: 'Got any sparks for a new project?',
  },
  {
    key: '2',
    icon: <InfoCircleOutlined style={{ color: '#1890FF' }} />,
    label: 'Uncover Background Info',
    description: 'Help me understand the background of this topic.',
  },
  {
    key: '3',
    icon: <RocketOutlined style={{ color: '#722ED1' }} />,
    label: 'Efficiency Boost Battle',
    description: 'How can I work faster and better?',
  },
  {
    key: '4',
    icon: <SmileOutlined style={{ color: '#52C41A' }} />,
    label: 'Tell me a Joke',
    description: 'Why do not ants get sick? Because they have tiny ant-bodies!',
  },
  {
    key: '5',
    icon: <WarningOutlined style={{ color: '#FF4D4F' }} />,
    label: 'Common Issue Solutions',
    description: 'How to solve common issues? Share some tips!',
  },
];

defineRender(() => (
  <Prompts
    title="✨ Inspirational Sparks and Marvelous Tips"
    items={items}
    wrap
    styles={{
      item: {
        flex: 'none',
        width: 'calc(50% - 6px)',
      },
    }}
  />
));
</script>

隐藏源代码

嵌套组合

API

PromptsProps

属性	说明	类型	默认值	版本
classNames	自定义样式类名，用于各个提示项的不同部分	Record<SemanticType, string>	-	-
fadeIn	是否开启渲染渐入	boolean	false	-
fadeInLeft	是否开启渲染从左到右渐入	boolean	false	-
items	包含多个提示项的列表	PromptProps[]	-	-
prefixCls	样式类名的前缀	string	-	-
rootClassName	根节点的样式类名	string	-	-
styles	自定义样式，用于各个提示项的不同部分	Record<SemanticType, CSSProperties>	-	-
title	显示在提示列表顶部的标题	VNode | string | (() => VNode | string)	-	-
vertical	设置为 true 时, 提示列表将垂直排列	boolean	false	-
wrap	设置为 true 时, 提示列表将自动换行	boolean	false	-
onItemClick	提示项被点击时的回调函数	(info: { data: PromptProps }) => void	-	-

SemanticType

type SemanticType = 'root' | 'list' | 'item' | 'itemContent' | 'title' | 'subList' | 'subItem';

Prompts Slots

插槽名	说明
title	显示在提示列表顶部的标题

Prompts Ref

属性	说明	类型
nativeElement	组件根 DOM 元素	HTMLDivElement

PromptProps

属性	说明	类型	默认值	版本
children	嵌套的子提示项	PromptProps[]	-	-
description	提示描述提供额外的信息	VNode | string	-	-
disabled	设置为 true 时禁用点击事件	boolean	false	-
icon	提示图标显示在提示项的左侧	VNode	-	-
key	唯一标识用于区分每个提示项	string	-	-
label	提示标签显示提示的主要内容	VNode | string	-	-

Semantic DOM

✨ Inspirational Sparks and Marvelous Tips

Ignite Your Creativity

Got any sparks for a new project?

Uncover Background Info

Help me understand the background of this topic.

Efficiency Boost Battle

How can I work faster and better?

• root

  根节点

• title

  标题容器

• list

  列表容器

• item

  列表项

• itemContent

  标题项内容

✨ Nested Prompts

🔥 Ignite Your Creativity

What sparks your creativity?

How do you get inspired?

🎨 Uncover Background Info

What is the background of this topic?

Why is this important?

• subList

  子列表容器

• subItem

  子列表项

主题变量（Design Token）

组件暂无自定义 Component Token，可通过全局 Design Token 定制。