このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください
NocoBaseの動的なテーマ機能にうまく対応するため、プラグインではantd-style を使ってスタイルを記述することをおすすめします。既存のテーマトークンと組み合わせることで、テーマの動的な機能を扱えます。さらに、NocoBaseにはスタイルを簡単に調整できるテーマエディタープラグインも用意されています。
import { createStyles } from 'antd-style';
const useStyles = createStyles(({ token, css }) => ({
// CSS オブジェクト形式をサポートしています
container: {
backgroundColor: token.colorBgLayout,
borderRadius: token.borderRadiusLG,
maxWidth: 400,
width: '100%',
height: 180,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
flexDirection: 'column',
marginLeft: 'auto',
marginRight: 'auto',
},
// また、CSS 文字列テンプレートを使うことで、通常のCSSと同じ記述体験が得られます
card: css`
color: ${token.colorTextTertiary};
box-shadow: ${token.boxShadow};
&:hover {
color: ${token.colorTextSecondary};
box-shadow: ${token.boxShadowSecondary};
}
padding: ${token.padding}px;
border-radius: ${token.borderRadius}px;
background: ${token.colorBgContainer};
transition: all 100ms ${token.motionEaseInBack};
margin-bottom: 8px;
cursor: pointer;
`,
}));
export default () => {
// styles オブジェクトは useStyles メソッド内でデフォルトでキャッシュされるため、再レンダリングの問題を心配する必要はありません
const { styles, cx, theme } = useStyles();
return (
// cx を使うと className を整理できます
<div
className={cx('a-simple-create-style-demo-classname', styles.container)}
>
<div className={styles.card}>createStyles Demo</div>
{/* theme オブジェクトには、すべてのトークンやテーマなどの情報が含まれています */}
<div>現在のテーマモード:{theme.appearance}</div>
</div>
);
};詳細な使用方法については、createStyles API を参照してください。
import { createStyles, createStylish, css } from 'antd-style';
const useStylish = createStylish(({ token, css }) => {
const containerBgHover = css`
cursor: pointer;
transition: 150ms background-color ease-in-out;
&:hover {
background: ${token.colorFillQuaternary};
}
`;
const defaultButtonBase = css`
color: ${token.colorTextSecondary};
background: ${token.colorFillQuaternary};
border-color: transparent;
`;
return {
defaultButton: css`
${defaultButtonBase};
&:hover {
color: ${token.colorText};
background: ${token.colorFillSecondary};
border-color: transparent;
}
&:focus {
${defaultButtonBase};
border-color: ${token.colorPrimary};
}
`,
containerBgHover: css`
cursor: pointer;
transition: 150ms background-color ease-in-out;
&:hover {
background: ${token.colorFillQuaternary};
}
`,
containerBgL2: css`
${containerBgHover};
border-radius: 4px;
background: ${token.colorFillQuaternary};
&:hover {
background: ${token.colorFillTertiary};
}
`,
};
});
const useStyles = createStyles({
// CSS オブジェクト形式をサポートしています
container: {
backgroundColor: '#f5f5f5',
maxWidth: 400,
width: '100%',
height: 180,
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
},
// また、CSS 文字列テンプレートを使うことで、通常のCSSと同じ記述体験が得られます
btn: css`
padding: 24px;
`,
});
export default () => {
const { styles, cx } = useStyles();
const stylish = useStylish();
return (
<div className={styles.container}>
<div className={cx(styles.btn, stylish.defaultButton)}>
stylish Button
</div>
</div>
);
};詳細な使用方法については、createStylish API を参照してください。
import { createGlobalStyle } from 'antd-style';
const Global = createGlobalStyle`
.some-class {
color: hotpink;
}
`;
export default () => {
return (
<div>
<Global />
<div className="some-class">グローバルスタイルが適用されたテキスト</div>
</div>
);
};詳細な使用方法については、createGlobalStyle API を参照してください。
createStyles の例
import { SmileOutlined } from '@ant-design/icons';
import { Button, Space } from 'antd';
import { createStyles } from 'antd-style';
const useStyles = createStyles(({ token, css }) => {
const commonCard = css`
border-radius: ${token.borderRadiusLG}px;
padding: ${token.paddingLG}px;
`;
return {
container: css`
background-color: ${token.colorBgLayout};
padding: 24px;
`,
primaryCard: css`
${commonCard};
background: ${token.colorPrimary};
color: ${token.colorTextLightSolid};
`,
defaultCard: css`
${commonCard};
background: ${token.colorBgContainer};
color: ${token.colorText};
`,
};
});
const App = () => {
const { styles } = useStyles();
return (
<div className={styles.container}>
<Space direction={'vertical'} style={{ width: '100%' }} size={16}>
<Space>
<Button title={'機能ボタンの説明'} icon={<SmileOutlined />} />
操作ボタン
</Space>
<div className={styles.defaultCard}>デフォルトカード</div>
<div className={styles.primaryCard}>プライマリーカード</div>
</Space>
</div>
);
};
export default App;createGlobalStyle の例
import { createGlobalStyle, ThemeProvider } from 'antd-style';
const Global = createGlobalStyle`
.ant-custom-button {
color: ${(p) => p.theme.colorPrimary};
background: ${(p) => p.theme.colorPrimaryBg};
height: ${(p) => p.theme.controlHeight}px;
border-radius: ${(p) => p.theme.borderRadius}px;
padding: 0 ${(p) => p.theme.paddingContentHorizontal}px;
:hover {
background: ${(p) => p.theme.colorPrimaryBgHover};
color: ${(p) => p.theme.colorPrimaryTextActive};
}
:active {
background: ${(p) => p.theme.colorPrimaryBorder};
color: ${(p) => p.theme.colorPrimaryText};
}
border: none;
cursor: pointer;
}
`;
export default () => {
return (
<ThemeProvider>
<Global />
<button className="ant-custom-button">antd に存在しないボタン</button>
</ThemeProvider>
);
};