adding docs subtree

2026-01-26 14:56:42 +08:00 · 2019-02-25 13:12:18 -08:00
parent 1adcc07a61
commit 41dcf8731d
365 changed files with 10620 additions and 0 deletions
--- a/docs/step2-02/README.md
+++ b/docs/step2-02/README.md
@@ -0,0 +1,32 @@
+# Step 2.2: UI Fabric Component Library
+
+[Lessons](../) | [Exercise](./exercise/) | [Demo](./demo/)
+
+UI Fabric is a Component Library that is developed to reflect the latest Microsoft design language. It is used in many Microsoft web applications and is developed in the open:
+
+https://github.com/officedev/office-ui-fabric-react
+
+Documentation can be found here:
+
+https://developer.microsoft.com/en-us/fabric/#/components
+
+## Learn about Components and How to Look up Documentation
+
+- Stack
+- Default Button / Primary Button
+
+# Exercise
+
+1. Open up the [Documentation for DefaultButton](https://developer.microsoft.com/en-us/fabric/#/components/button)
+2. Open up the TSX files inside `components/`
+3. Replace the DOM tags with Fabric components in those TSX files with these components:
+
+- Stack
+- DefaultButton
+- Checkbox
+- TextField
+- Pivot (for the filter)
+
+# Bonus Exercise
+
+GO WILD! There are so many components from the Fabric library! Try to put some components in the exercise component files.
--- a/docs/step2-02/demo/index.html
+++ b/docs/step2-02/demo/index.html
@@ -0,0 +1 @@
+<!doctype html><html><head><link rel="stylesheet" href="../../assets/step.css"></head><body class="ms-Fabric"><div id="markdownReadme"></div><div id="app"></div><script src="../../step2-02/demo/step2-02/demo.js"></script><script src="../../markdownReadme/markdownReadme.js"></script></body></html>
--- a/docs/step2-02/demo/src/components/TodoApp.tsx
+++ b/docs/step2-02/demo/src/components/TodoApp.tsx
@@ -0,0 +1,87 @@
+import React from 'react';
+import { Stack } from 'office-ui-fabric-react';
+import { TodoFooter } from './TodoFooter';
+import { TodoHeader } from './TodoHeader';
+import { TodoList } from './TodoList';
+import { Store } from '../store';
+
+let index = 0;
+
+export class TodoApp extends React.Component<any, Store> {
+  constructor(props) {
+    super(props);
+    this.state = {
+      todos: {},
+      filter: 'all'
+    };
+  }
+  render() {
+    const { filter, todos } = this.state;
+    return (
+      <Stack horizontalAlign="center">
+        <Stack style={{ width: 400 }} gap={25}>
+          <TodoHeader addTodo={this._addTodo} setFilter={this._setFilter} filter={filter} />
+          <TodoList complete={this._complete} todos={todos} filter={filter} remove={this._remove} edit={this._edit} />
+          <TodoFooter clear={this._clear} todos={todos} />
+        </Stack>
+      </Stack>
+    );
+  }
+
+  private _addTodo = label => {
+    const { todos } = this.state;
+    const id = index++;
+
+    this.setState({
+      todos: { ...todos, [id]: { label } }
+    });
+  };
+
+  private _remove = id => {
+    const newTodos = { ...this.state.todos };
+    delete newTodos[id];
+
+    this.setState({
+      todos: newTodos
+    });
+  };
+
+  private _complete = id => {
+    const newTodos = { ...this.state.todos };
+    newTodos[id].completed = !newTodos[id].completed;
+
+    this.setState({
+      todos: newTodos
+    });
+  };
+
+  private _edit = (id, label) => {
+    const newTodos = { ...this.state.todos };
+    newTodos[id] = { ...newTodos[id], label };
+
+    this.setState({
+      todos: newTodos
+    });
+  };
+
+  private _clear = () => {
+    const { todos } = this.state;
+    const newTodos = {};
+
+    Object.keys(this.state.todos).forEach(id => {
+      if (!todos[id].completed) {
+        newTodos[id] = todos[id];
+      }
+    });
+
+    this.setState({
+      todos: newTodos
+    });
+  };
+
+  private _setFilter = filter => {
+    this.setState({
+      filter: filter
+    });
+  };
+}
--- a/docs/step2-02/demo/src/components/TodoFooter.tsx
+++ b/docs/step2-02/demo/src/components/TodoFooter.tsx
@@ -0,0 +1,23 @@
+import React from 'react';
+import { Text } from '@uifabric/experiments';
+import { Stack } from 'office-ui-fabric-react';
+import { Store } from '../store';
+import { DefaultButton } from 'office-ui-fabric-react';
+
+interface TodoFooterProps {
+  clear: () => void;
+  todos: Store['todos'];
+}
+
+export const TodoFooter = (props: TodoFooterProps) => {
+  const itemCount = Object.keys(props.todos).filter(id => !props.todos[id].completed).length;
+
+  return (
+    <Stack horizontal horizontalAlign="space-between">
+      <Text>
+        {itemCount} item{itemCount > 1 ? 's' : ''} left
+      </Text>
+      <DefaultButton onClick={() => props.clear()}>Clear Completed</DefaultButton>
+    </Stack>
+  );
+};
--- a/docs/step2-02/demo/src/components/TodoHeader.tsx
+++ b/docs/step2-02/demo/src/components/TodoHeader.tsx
@@ -0,0 +1,58 @@
+import React from 'react';
+import { Text } from '@uifabric/experiments';
+import { Stack } from 'office-ui-fabric-react';
+import { Pivot, PivotItem, TextField, PrimaryButton } from 'office-ui-fabric-react';
+import { FilterTypes } from '../store';
+
+interface TodoHeaderProps {
+  addTodo: (label: string) => void;
+  setFilter: (filter: FilterTypes) => void;
+  filter: string;
+}
+
+interface TodoHeaderState {
+  labelInput: string;
+}
+
+export class TodoHeader extends React.Component<TodoHeaderProps, TodoHeaderState> {
+  constructor(props: TodoHeaderProps) {
+    super(props);
+    this.state = { labelInput: undefined };
+  }
+
+  render() {
+    return (
+      <Stack>
+        <Stack horizontal horizontalAlign="center">
+          <Text variant="xxLarge">todos</Text>
+        </Stack>
+
+        <Stack horizontal>
+          <Stack.Item grow>
+            <TextField placeholder="What needs to be done?" value={this.state.labelInput} onChange={this.onChange} />
+          </Stack.Item>
+          <PrimaryButton onClick={this.onAdd}>Add</PrimaryButton>
+        </Stack>
+
+        <Pivot onLinkClick={this.onFilter}>
+          <PivotItem headerText="all" />
+          <PivotItem headerText="active" />
+          <PivotItem headerText="completed" />
+        </Pivot>
+      </Stack>
+    );
+  }
+
+  private onAdd = () => {
+    this.props.addTodo(this.state.labelInput);
+    this.setState({ labelInput: undefined });
+  };
+
+  private onChange = (evt: React.FormEvent<HTMLInputElement>, newValue: string) => {
+    this.setState({ labelInput: newValue });
+  };
+
+  private onFilter = (item: PivotItem) => {
+    this.props.setFilter(item.props.headerText as FilterTypes);
+  };
+}
--- a/docs/step2-02/demo/src/components/TodoList.tsx
+++ b/docs/step2-02/demo/src/components/TodoList.tsx
@@ -0,0 +1,27 @@
+import React from 'react';
+import { Stack } from 'office-ui-fabric-react';
+import { TodoListItem } from './TodoListItem';
+import { Store, FilterTypes } from '../store';
+
+interface TodoListProps {
+  complete: (id: string) => void;
+  remove: (id: string) => void;
+  todos: Store['todos'];
+  filter: FilterTypes;
+  edit: (id: string, label: string) => void;
+}
+
+export const TodoList = (props: TodoListProps) => {
+  const { filter, todos, complete, remove, edit } = props;
+  const filteredTodos = Object.keys(todos).filter(id => {
+    return filter === 'all' || (filter === 'completed' && todos[id].completed) || (filter === 'active' && !todos[id].completed);
+  });
+
+  return (
+    <Stack gap={10}>
+      {filteredTodos.map(id => (
+        <TodoListItem key={id} id={id} todos={todos} complete={complete} remove={remove} edit={edit} />
+      ))}
+    </Stack>
+  );
+};
--- a/docs/step2-02/demo/src/components/TodoListItem.tsx
+++ b/docs/step2-02/demo/src/components/TodoListItem.tsx
@@ -0,0 +1,75 @@
+import React from 'react';
+import { Stack, Checkbox, IconButton, TextField, DefaultButton } from 'office-ui-fabric-react';
+import { Store } from '../store';
+
+interface TodoListItemProps {
+  id: string;
+  todos: Store['todos'];
+  remove: (id: string) => void;
+  complete: (id: string) => void;
+  edit: (id: string, label: string) => void;
+}
+
+interface TodoListItemState {
+  editing: boolean;
+  editLabel: string;
+}
+
+export class TodoListItem extends React.Component<TodoListItemProps, TodoListItemState> {
+  constructor(props: TodoListItemProps) {
+    super(props);
+    this.state = { editing: false, editLabel: undefined };
+  }
+
+  render() {
+    const { todos, id, complete, remove } = this.props;
+    const item = todos[id];
+
+    return (
+      <Stack horizontal verticalAlign="center" horizontalAlign="space-between">
+        {!this.state.editing && (
+          <>
+            <Checkbox label={item.label} checked={item.completed} onChange={() => complete(id)} />
+            <div>
+              <IconButton iconProps={{ iconName: 'Edit' }} className="clearButton" onClick={this.onEdit} />
+              <IconButton iconProps={{ iconName: 'Cancel' }} className="clearButton" onClick={() => remove(id)} />
+            </div>
+          </>
+        )}
+
+        {this.state.editing && (
+          <Stack.Item grow>
+            <Stack horizontal>
+              <Stack.Item grow>
+                <TextField value={this.state.editLabel} onChange={this.onChange} />
+              </Stack.Item>
+              <DefaultButton onClick={this.onDoneEdit}>Save</DefaultButton>
+            </Stack>
+          </Stack.Item>
+        )}
+      </Stack>
+    );
+  }
+
+  private onEdit = () => {
+    const { todos, id } = this.props;
+    const { label } = todos[id];
+
+    this.setState({
+      editing: true,
+      editLabel: this.state.editLabel || label
+    });
+  };
+
+  private onDoneEdit = () => {
+    this.props.edit(this.props.id, this.state.editLabel);
+    this.setState({
+      editing: false,
+      editLabel: undefined
+    });
+  };
+
+  private onChange = (evt: React.FormEvent<HTMLInputElement>, newValue: string) => {
+    this.setState({ editLabel: newValue });
+  };
+}
--- a/docs/step2-02/demo/src/index.tsx
+++ b/docs/step2-02/demo/src/index.tsx
@@ -0,0 +1,10 @@
+import React from 'react';
+import ReactDOM from 'react-dom';
+import { TodoApp } from './components/TodoApp';
+import { initializeIcons } from '@uifabric/icons';
+
+// Initializes the UI Fabric icons that we can use
+// Choose one from this list: https://developer.microsoft.com/en-us/fabric#/styles/icons
+initializeIcons();
+
+ReactDOM.render(<TodoApp />, document.getElementById('app'));
--- a/docs/step2-02/demo/src/store/index.ts
+++ b/docs/step2-02/demo/src/store/index.ts
@@ -0,0 +1,14 @@
+export type FilterTypes = 'all' | 'active' | 'completed';
+
+export interface TodoItem {
+  label: string;
+  completed: boolean;
+}
+
+export interface Store {
+  todos: {
+    [id: string]: TodoItem;
+  };
+
+  filter: FilterTypes;
+}
--- a/docs/step2-02/demo/step2-02/demo.js
+++ b/docs/step2-02/demo/step2-02/demo.js
--- a/docs/step2-02/demo/step2-02/demo.js.map
+++ b/docs/step2-02/demo/step2-02/demo.js.map
--- a/docs/step2-02/exercise/index.html
+++ b/docs/step2-02/exercise/index.html
@@ -0,0 +1 @@
+<!doctype html><html><head><link rel="stylesheet" href="../../assets/step.css"></head><body class="ms-Fabric"><div id="markdownReadme"></div><div id="app"></div><script src="../../step2-02/exercise/step2-02/exercise.js"></script><script src="../../markdownReadme/markdownReadme.js"></script></body></html>
--- a/docs/step2-02/exercise/src/components/TodoApp.tsx
+++ b/docs/step2-02/exercise/src/components/TodoApp.tsx
@@ -0,0 +1,20 @@
+import React from 'react';
+import { Stack } from 'office-ui-fabric-react';
+import { TodoFooter } from './TodoFooter';
+import { TodoHeader } from './TodoHeader';
+import { TodoList } from './TodoList';
+import { Store } from '../store';
+
+export class TodoApp extends React.Component<any, Store> {
+  render() {
+    return (
+      <Stack horizontalAlign="center">
+        <Stack style={{ width: 400 }} gap={25}>
+          <TodoHeader />
+          <TodoList />
+          <TodoFooter />
+        </Stack>
+      </Stack>
+    );
+  }
+}
--- a/docs/step2-02/exercise/src/components/TodoFooter.tsx
+++ b/docs/step2-02/exercise/src/components/TodoFooter.tsx
@@ -0,0 +1,16 @@
+import React from 'react';
+
+export const TodoFooter = (props: any) => {
+  const itemCount = 3;
+
+  return (
+    <footer>
+      <span>
+        {itemCount} item{itemCount > 1 ? 's' : ''} left
+      </span>
+      <button onClick={() => props.clear()} className="button">
+        Clear Completed
+      </button>
+    </footer>
+  );
+};
--- a/docs/step2-02/exercise/src/components/TodoHeader.tsx
+++ b/docs/step2-02/exercise/src/components/TodoHeader.tsx
@@ -0,0 +1,19 @@
+import React from 'react';
+import { FilterTypes } from '../store';
+
+export class TodoHeader extends React.Component<{}, {}> {
+  render() {
+    return (
+      <div>
+        <h1>todos</h1>
+        <input className="textfield" placeholder="add todo" />
+        <button className="button add">Add</button>
+        <div className="filter">
+          <button>all</button>
+          <button>active</button>
+          <button>completed</button>
+        </div>
+      </div>
+    );
+  }
+}
--- a/docs/step2-02/exercise/src/components/TodoList.tsx
+++ b/docs/step2-02/exercise/src/components/TodoList.tsx
@@ -0,0 +1,13 @@
+import React from 'react';
+import { Stack } from 'office-ui-fabric-react';
+import { TodoListItem } from './TodoListItem';
+
+export const TodoList = (props: any) => {
+  return (
+    <ul className="todos">
+      <TodoListItem />
+      <TodoListItem />
+      <TodoListItem />
+    </ul>
+  );
+};
--- a/docs/step2-02/exercise/src/components/TodoListItem.tsx
+++ b/docs/step2-02/exercise/src/components/TodoListItem.tsx
@@ -0,0 +1,13 @@
+import React from 'react';
+
+export class TodoListItem extends React.Component<any, any> {
+  render() {
+    return (
+      <li className="todo">
+        <label>
+          <input type="checkbox" defaultChecked={false} /> test item
+        </label>
+      </li>
+    );
+  }
+}
--- a/docs/step2-02/exercise/src/index.tsx
+++ b/docs/step2-02/exercise/src/index.tsx
@@ -0,0 +1,10 @@
+import React from 'react';
+import ReactDOM from 'react-dom';
+import { TodoApp } from './components/TodoApp';
+import { initializeIcons } from '@uifabric/icons';
+
+// Initializes the UI Fabric icons that we can use
+// Choose one from this list: https://developer.microsoft.com/en-us/fabric#/styles/icons
+initializeIcons();
+
+ReactDOM.render(<TodoApp />, document.getElementById('app'));
--- a/docs/step2-02/exercise/src/store/index.ts
+++ b/docs/step2-02/exercise/src/store/index.ts
@@ -0,0 +1,14 @@
+export type FilterTypes = 'all' | 'active' | 'completed';
+
+export interface TodoItem {
+  label: string;
+  completed: boolean;
+}
+
+export interface Store {
+  todos: {
+    [id: string]: TodoItem;
+  };
+
+  filter: FilterTypes;
+}
--- a/docs/step2-02/exercise/step2-02/exercise.js
+++ b/docs/step2-02/exercise/step2-02/exercise.js
--- a/docs/step2-02/exercise/step2-02/exercise.js.map
+++ b/docs/step2-02/exercise/step2-02/exercise.js.map
				`@@ -0,0 +1 @@`
				`<!doctype html><html><head><link rel="stylesheet" href="../../assets/step.css"></head><body class="ms-Fabric"><div id="markdownReadme"></div><div id="app"></div><script src="../../step2-02/demo/step2-02/demo.js"></script><script src="../../markdownReadme/markdownReadme.js"></script></body></html>`