{"componentChunkName":"component---src-templates-post-template-js","path":"/en-US/feedback/banner","result":{"data":{"current":{"frontmatter":{"title":"Banner","order":87,"brief":"The Banner component is usually used to identify the status or notification of the full page. It is usually resident and requires the user to close it initiatively.","icon":"doc-banner"},"fields":{"type":"feedback"},"tableOfContents":{"items":[{"url":"#demos","title":"Demos","items":[{"url":"#how-to-import","title":"How to import"},{"url":"#basic-usage","title":"Basic Usage"},{"url":"#types","title":"Types"},{"url":"#use-in-container","title":"Use in Container"},{"url":"#customized-content","title":"Customized Content"}]},{"url":"#api-reference","title":"API Reference"},{"url":"#accessibility","title":"Accessibility","items":[{"url":"#aria","title":"ARIA"},{"url":"#keyboard-and-focus","title":"Keyboard and Focus"}]},{"url":"#content-guidelines","title":"Content Guidelines"},{"url":"#design-tokens","title":"Design Tokens"}]},"body":"var _excluded = [\"components\"];\nfunction _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }\nfunction _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var s = Object.getOwnPropertySymbols(e); for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }\nfunction _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.includes(n)) continue; t[n] = r[n]; } return t; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {\n  \"localeCode\": \"en-US\",\n  \"order\": 87,\n  \"category\": \"Feedback\",\n  \"title\": \"Banner\",\n  \"subTitle\": \"Banner\",\n  \"icon\": \"doc-banner\",\n  \"dir\": \"column\",\n  \"brief\": \"The Banner component is usually used to identify the status or notification of the full page. It is usually resident and requires the user to close it initiatively.\"\n};\nvar makeShortcode = function makeShortcode(name) {\n  return function MDXDefaultShortcode(props) {\n    console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\");\n    return mdx(\"div\", props);\n  };\n};\nvar DesignToken = makeShortcode(\"DesignToken\");\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"section\", null, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Demos\"), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"How to import\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-jsx\",\n    \"metastring\": \"import\",\n    \"import\": true\n  }, \"import { Banner } from '@douyinfe/semi-ui';\\n\")), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Basic Usage\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-jsx\",\n    \"metastring\": \"live=true dir=\\\"column\\\"\",\n    \"live\": \"true\",\n    \"dir\": \"\\\"column\\\"\"\n  }, \"import React, { useState } from 'react';\\nimport { Banner, Layout, Button } from '@douyinfe/semi-ui';\\n\\n() => {\\n    const [visible, setVisible] = useState(false);\\n    const changeVisible = () => {\\n        setVisible(!visible);\\n    };\\n    const { Header, Footer, Content } = Layout;\\n    const banner = (\\n        <Banner \\n            onClose={changeVisible}\\n            description=\\\"A pre-released version is available\\\"\\n        />\\n    );\\n    return (\\n        <>\\n            <Layout className='components-layout-demo banner-basic'>\\n                <Header>Header</Header>\\n                {visible? banner : null}\\n                <Content>Content</Content>\\n                <Footer>Footer</Footer>\\n            </Layout>\\n            <Button\\n                onClick={changeVisible}\\n                style={{\\n                    display: 'block',\\n                    width: '120px',\\n                    margin: '0 auto'\\n                }}\\n            >\\n                { visible ? 'Hide Banner' : 'Show Banner' }\\n            </Button>\\n        </>\\n    );\\n};\\n\")), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Types\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"The \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"type\"), \" prop supports one of: \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"default\"), \"(default),\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"danger\"), \",\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"warning\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"success\"), \".\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-jsx\",\n    \"metastring\": \"live=true dir=\\\"column\\\"\",\n    \"live\": \"true\",\n    \"dir\": \"\\\"column\\\"\"\n  }, \"import React from 'react';\\nimport { Banner } from '@douyinfe/semi-ui';\\n\\n() => (\\n    <>\\n        <Banner \\n            type=\\\"info\\\"\\n            description=\\\"A pre-released version is available.\\\"\\n        />\\n        <br/>\\n        <Banner \\n            type=\\\"warning\\\"\\n            description=\\\"This version of the document is going to expire after 4 days.\\\"\\n        />\\n        <br/>\\n        <Banner \\n            type=\\\"danger\\\"\\n            description=\\\"This document was deprecated since Jan 1, 2019.\\\"\\n        />\\n        <br/>\\n        <Banner \\n            type=\\\"success\\\"\\n            description=\\\"You are viewing the latest version of this document.\\\"\\n        />\\n    </>\\n);\\n\")), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Use in Container\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"You could set  \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"fullMode={false}\"), \" to use style for non-fullscreen mode\\u3002\\nAlso, use \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"bordered\"), \" for bordered style.\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-jsx\",\n    \"metastring\": \"live=true dir=\\\"column\\\"\",\n    \"live\": \"true\",\n    \"dir\": \"\\\"column\\\"\"\n  }, \"import React from 'react';\\nimport { Banner, Typography } from '@douyinfe/semi-ui';\\n\\nfunction Demo() {\\n    const { Text } = Typography;\\n  \\n    return (\\n        <div style={{ width: 640 }} className=\\\"components-banner-demo\\\">\\n            <Banner fullMode={false} type=\\\"info\\\" bordered icon={null} closeIcon={null}\\n                title={<div style={{ fontWeight: 600, fontSize: '14px', lineHeight: '20px' }}>{`Don't know AppKey?`}</div>}\\n                description={<div>You can contact the corresponding R & D students to confirm whether you have applied for an application on <Text link={{ href: 'https://semi.design/' }}>the application cloud platform</Text> , and fill in the corresponding information.</div>}\\n            /><br/>\\n            <Banner fullMode={false} type=\\\"warning\\\" bordered icon={null} closeIcon={null}\\n                title={<div style={{ fontWeight: 600, fontSize: '14px', lineHeight: '20px' }}>{`Don't know AppKey?`}</div>}\\n                description={<div>You can contact the corresponding R & D students to confirm whether you have applied for an application on <Text link={{ href: 'https://semi.design/' }}>the application cloud platform</Text> , and fill in the corresponding information.</div>}\\n            /><br/>\\n            <Banner fullMode={false} type=\\\"danger\\\" bordered icon={null} closeIcon={null}\\n                title={<div style={{ fontWeight: 600, fontSize: '14px', lineHeight: '20px' }}>{`Don't know AppKey?`}</div>}\\n                description={<div>You can contact the corresponding R & D students to confirm whether you have applied for an application on <Text link={{ href: 'https://semi.design/' }}>the application cloud platform</Text> , and fill in the corresponding information.</div>}\\n            /><br/>\\n            <Banner fullMode={false} type=\\\"success\\\" bordered icon={null} closeIcon={null}\\n                title={<div style={{ fontWeight: 600, fontSize: '14px', lineHeight: '20px' }}>{`Don't know AppKey?`}</div>}\\n                description={<div>You can contact the corresponding R & D students to confirm whether you have applied for an application on <Text link={{ href: 'https://semi.design/' }}>the application cloud platform</Text> , and fill in the corresponding information.</div>}\\n            />\\n        </div>\\n    );\\n}\\n\")), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-css\"\n  }, \".components-banner-demo {\\n    .semi-banner-info.semi-banner-bordered {\\n        border: 1px solid var(--semi-color-primary-disabled);\\n    }\\n    .semi-banner-warning.semi-banner-bordered {\\n        border: 1px solid var(--semi-color-warning-light-active);\\n    }\\n    .semi-banner-danger.semi-banner-bordered {\\n        border: 1px solid var(--semi-color-danger-light-active);\\n    }\\n    .semi-banner-success.semi-banner-bordered {\\n        border: 1px solid var(--semi-color-success-light-active);\\n    }\\n}\\n\")), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Customized Content\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Use \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"children\"), \" to create customized content.\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-jsx\",\n    \"metastring\": \"live=true dir=\\\"column\\\"\",\n    \"live\": \"true\",\n    \"dir\": \"\\\"column\\\"\"\n  }, \"import React from 'react';\\nimport { Banner } from '@douyinfe/semi-ui';\\n\\n() => (\\n    <div style={{ width: 500, padding: 20, border: '1px solid var(--semi-color-border)' }}>\\n        <Banner\\n            fullMode={false}\\n            title=\\\"Title\\\"\\n            type=\\\"warning\\\"\\n            bordered\\n            description=\\\"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat\\\"\\n        >\\n            <div className=\\\"semi-modal-footer\\\">\\n                <button className=\\\"semi-button semi-button-tertiary semi-button-light\\\" type=\\\"button\\\">No, thanks.</button>\\n                <button className=\\\"semi-button semi-button-warning\\\" type=\\\"button\\\">Sounds great!</button>\\n            </div>\\n        </Banner>\\n        <br/>\\n    </div>\\n);\\n\"))), mdx(\"section\", null, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"API Reference\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Properties\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Instructions\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Default\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Version\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"bordered\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Toggle if show border, only affects in non-fullscreen mode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"boolean\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"false\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"className\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Classname\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"string\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"closeIcon\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Custom close icon\\uFF0Cno icon if passed null\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ReactNode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"description\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description texts\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ReactNode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"fullMode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Toggle if banner is full screen\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"boolean\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"true\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"icon\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Custom icon, no icon if passed null\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ReactNode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"onClose\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Callback function when close banner\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"function\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"style\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Style\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"object\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"title\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Title\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ReactNode\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"1.0\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type of banner, one of \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"info\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"success\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"danger\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"warning\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"string\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"info\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"-\"))))), mdx(\"section\", null, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Accessibility\"), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"ARIA\"), mdx(\"ul\", {\n    parentName: \"section\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"The component has a \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"role\"), \" of 'alert'.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"The close icon has a \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"aria-label\"), \" of 'Close'.\")), mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Keyboard and Focus\"), mdx(\"ul\", {\n    parentName: \"section\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"The close button of the Banner can be focused with the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"Tab\"), \" key. After the button is focused, hit the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"Enter\"), \" key or the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"Space\"), \" key to close the banner.\"))), mdx(\"section\", null, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Content Guidelines\"), mdx(\"ul\", {\n    parentName: \"section\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Full screen Banner\", mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Try to keep the content displayed completely on one line\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Use correct punctuation, commas within sentences and periods between sentences\"))), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Non-fullscreen Banner\", mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"title\", mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Instructions in condensed language\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Try to avoid using commas, periods and other punctuation marks in the title, and support the use of question marks at the end when there are and only interrogative sentences\"))), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"text\", mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"On the premise of complete information transmission, try to compress the text to 1-2 sentences\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"A detailed description or explanation of the title, rather than a repetition of the title\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Use correct punctuation, commas within sentences and periods between sentences\"))))))), mdx(\"section\", null, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Design Tokens\"), mdx(DesignToken, {\n    mdxType: \"DesignToken\"\n  })));\n}\n;\nMDXContent.isMDXComponent = true;"}},"pageContext":{"slug":"en-US/feedback/banner","next":{"fields":{"slug":"zh-CN/feedback/banner"},"id":"0df76d94-5818-529c-87e6-b3bb0fe27b54","frontmatter":{"title":"Banner 通知横幅","localeCode":"zh-CN","icon":"doc-banner","showNew":null}},"previous":{"fields":{"slug":"zh-CN/show/chart"},"id":"065d34e0-127e-5ff0-915a-ef3457e09b58","frontmatter":{"title":"Semi DV 数据可视化","localeCode":"zh-CN","icon":"doc-vchart","showNew":null}}}},"staticQueryHashes":["1348983216108720","1477422646108720","3245198693108720","417590761108720","63159454108720"]}